home *** CD-ROM | disk | FTP | other *** search
/ PC Media 4 / PC MEDIA CD04.iso / share / udos / rutils30 / readme.txt < prev    next >
Encoding:
Text File  |  1992-08-03  |  7.9 KB  |  171 lines
  1.  
  2.  
  3.      ######  #     # #######   ###   #        #####           #####
  4.      #     # #     #    #       #    #       #     #         #     #
  5.      #     # #     #    #       #    #       #                     #
  6.      ######  #     #    #       #    #        #####           #####
  7.      #   #   #     #    #       #    #             #               #
  8.      #    #  #     #    #       #    #       #     #         #     #
  9.      #     #  #####     #      ###   #######  #####           #####
  10.  
  11.  
  12. This is version 3 of Rickis little useful (?) DOS utilities. If you have
  13. comments or suggestions, please tell me. As usual,  you use the programs
  14. at  your own  risk. I cannot be made responsible for any damages. I give
  15. no implicit or explicit warranties.
  16.  
  17. All programs  were   programmed  with Turbo  Pascal  6.0   on  a  286 AT
  18. compatible machine. Each  of  them is tested  to   a reasonable level of
  19. stability (I use  them  myself :-) ).  If   you encounter errors, please
  20. contact me. I  suppose  you need at  least   DOS   3.x to run everything
  21. successfully  (but I  tested  it only with  DRDOS   6.0.   If  you own a
  22. different machine or  run another  configuration, please tell  me, so  I
  23. will know that it runs on other circumstances, too).
  24.  
  25. This software is distributed as freeware. You  may copy it wherever  you
  26. like. The copyright however  may not be removed  (it   won't be as easy,
  27. anyway). It is  not necessary  (although recommended) to  keep the whole
  28. archive file intact. The whole stuff is to be  given away for free.  You
  29. may  only charge a minimal fee to   cover the  distribution or  diskette
  30. costs.
  31.  
  32. All the programs are a product of my hobby, not my profession.
  33.  
  34.  
  35. Currently there are these programs:
  36.  
  37. ASET            Advanced SET command
  38. BANNER          Display strings in huge letters (unix)
  39. CAL             Display a calendar (unix)
  40. CAT             Append several outputs to stdout (unix)
  41. CUT             Remove selected fields from each line of a file (unix)
  42. CHMOD           Change the attributes of files (unix)
  43. DBUTL           Display information and contents of dBase DBF files
  44. DETAB           Change tabs to spaces in several files
  45. ENTAB           Change spaces to tabs in several files
  46. FILEINFO        Recognition of several file formats
  47. FMT             ASCII text formatter (unix)
  48. GENOUT          Generate program fragments for textual output
  49. HD              Display hex dumps of several files
  50. HEAD            Show the first lines of a file (unix)
  51. LOCASE          Change chars in several files from upper to lower case
  52. NC              Number conversion utility
  53. NODUP           Remove successive equal lines from files
  54. STRINGS         Find printable strings in an object file or binary (unix)
  55. TEE             Duplicate textual output to a file (unix)
  56. UPCASE          Change chars in several files from lower to upper case
  57. WC              Count words, lines, and chars of several text files (unix)
  58.  
  59.  
  60. Those with  a (unix) appendix  are  similar  to  the  equally-named unix
  61. commands. For more  detailed information call  <prog> -h, <prog> -H, and
  62. <prog> -v.   UI.TXT contains  additional information on how the programs
  63. behave: how the options may be specified, how the DOS ERRORLEVEL is set,
  64. how strings may be quoted in the command line, and some more.
  65.  
  66.  
  67. Some notes:
  68.  
  69.   ASET is mostly  upward-compatible with a shareware utility called XSET
  70.   (see Credits) which I chose not  to use because of its missing boolean
  71.   and arithmetic operators.   There are, however, some functions which I
  72.   did not (yet) re-implement.  If   you need them, I  recommend you  use
  73.   XSET. Here are the differences between  ASET and XSET (I had a version
  74.   from 1990):
  75.  
  76.  
  77.   Not in ASET, but in XSET are
  78.      DEVICE, EXTFREE, FASTDRIVE, GETFIRST, GETLINE, GETHEAD, LIMFREE,
  79.      LIMSIZE, MATCH, RAMSIZE, LABEL
  80.   Substantially modified in respect to XSET are
  81.      GETKEY, GETSTRING, GETNUMBER
  82.   Nearly the same functionality have
  83.      ADD, COUNT, DATE, DAY, DIR, DISKROOM, DIV, DOSPATH, FILEDRIVE,
  84.      FILEEXT, FILENAME, FILENAMEX, FILEPATH, FILESIZE, INSTR, LEFT, LEN,
  85.      MID, MOD, MONTH, MONTHNAME, MUL, NTH, RAMFREE, RIGHT, SUB, TIME,
  86.      UNIQUE, WDAY, WDAYNAME, BUFFERS, FILES
  87.   Not in XSET, but in ASET are
  88.      ABS, AND, ARCTAN, COS, COSD, COSH, DELETE, DOSVER, DOY, E,
  89.      ENVCOUNT, ENVUSED, EPS, EQ, EXP, FAC, FILEATTR, FILEDATE, FILEDIR,
  90.      FILETIME, FRAC, GE, GT, INT, LE, LEAPYEAR, LN, LOCASE, LOG, LT,
  91.      MAX, MIN, NAND, NE, NOR, NOT, NULL, OR, PI, POT, SIN, SIND, SINH,
  92.      SOUNDEX, SQR, SQRT, SUBST, SUBSTALL, TAN, TAND, TANH, TYPE, UPCASE,
  93.      XOR, BOOTDRIVE
  94.   These are the synonyms for some of the above commands
  95.      !, !=, #, *, +, -, /, =, ATAN, DISKFREE, FATTR, FDATE, FDRIVE,
  96.      FEXT, FNAME, FNAMEX, FPATH, FSIZE, FDIR, FTIME, ^
  97.  
  98.   Some notes about FILEINFO:
  99.    - It has been tested with several files of each type
  100.    - The colors of a TIFF image are computed using only the first plane
  101.    - If you find a picture  with a format which should be,  but  is  not
  102.      recognized  by  FILEINFO, send   me   the  file. I will then try to
  103.      correct the error. Also, if you find a description of a new format,
  104.      it would be nice to send it  to me, so I can include it  in  future
  105.      releases
  106.    - I am looking for several format descriptions:  PCPaint/Pictor  PIC,
  107.      Mac PICT, HP PCL, and Silicon Graphics SGI
  108.    - Note that there may be files which are misinterpreted  by FILEINFO.
  109.      The identification may be fooled, because I restrict it to some few
  110.      bytes for  efficiency   reasons (you wouldn't want   to   wait some
  111.      minutes for FILEINFO to scan one directory...)
  112.  
  113. - DBUTL is designed for dBase III+ DBF files. If you use it successfully
  114.   with any other version, please tell me.
  115.  
  116.  
  117. Source Code Availability:
  118.  
  119.   TP6 Source code is available for some parts of   the  distribution  on
  120.   explicit request, namely the parts I did not write myself. There is no
  121.   way to get the source code of the parts I programmed! BTW, I point you
  122.   to Timo Salmis collection of TP goodies (no source  code, only  TPUs).
  123.   Here is what you can get from me:
  124.  
  125.         env.pas         modify shell variables from TP (see Credits)
  126.         dbasetb.pas     dBase III+ tool box (see Credits)
  127.         runtmerr.pas    PD RunTmErr unit (see Credits)
  128.  
  129.  
  130. Problems/Todos/Bugs:
  131.  
  132.    -    Got  a problem when using pipes with  multiple input from stdin.
  133.         E.g. 'DIR | LOCASE - -' terminates  without accepting the second
  134.         input while 'LOCASE - -' works as expected. There seems to be no
  135.         solution to this...
  136.    -    There should  be more  documentation. Well, I  think this is the
  137.         (only?) difference to commercial software :-)
  138.  
  139.  
  140. Credits:
  141.  
  142. - Thanks to my wife Marita Breuer for beta-testing the programs
  143. - Thanks  to Prof. Timo  Salmi (email: ts@uwasa.fi) of the University of
  144.   Vaasa, Finland. His TPUs can be anonymously ftp'ed from garbo.uwasa.fi
  145.   (128.214.87.1)      in    /pc/ts/tspaXXYY.zip,   where     XX=version,
  146.   YY=40,50,55,60
  147. - Thanks to  Klaus Dilper  for his Env  unit. Contact  address (from the
  148.   unit header):
  149.       Klaus Dilper
  150.       Universitaet Karlsruhe
  151.       Rechenzentrum
  152.       Zirkel 2
  153.       D-7500 Karlsruhe 1
  154.       Tel. 0721/608-4040          <-- foreign calls +49 721 6084040 [Ricki]
  155.       E-mail ===> RZ79@DKAUNI2.BITNET
  156. - Thanks to O. Wehrheim for his dBaseTB unit from Software Journal 06/87
  157. - XSET is (c) 1990 by Francesco Balena, via Niceforo 18, 70124 Bari, Italy
  158. - Thanks to David Conrad (dave@tygra.ddmi.com) for his PD RunTmErr unit
  159. - Thanks to Fabrice Bellard for his EXCELLENT freeware LZEXE program
  160. - Thanks to Teddy Matsumoto for his EXCELLENT freeware DIET program
  161. - Thanks to AC/DC, Metallica, Flotsam & Jetsam, and Slayer for their tunes
  162.  
  163.  
  164. If I  find  the  time (and ideas...), I will add some more utilities. If
  165. you like  'em,  drop me an  e-mail or  a postcard  from where U live (It
  166. would be nice to get some feedback).
  167.  
  168.  
  169. Until then, Ricki.
  170.  
  171.